home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / zodiac40.zip / ZODIAC.DOC < prev    next >
Text File  |  1992-04-02  |  11KB  |  260 lines

  1.  
  2.  
  3.                                    ZODIAC
  4.  
  5.                             a DOORware program by
  6.                                 Roland Haley
  7.                              Copyright (C) 1992
  8.                                     using
  9.  
  10.                                 DOORPCH v3.8
  11.  
  12.                                      by
  13.                                Raymond Clements
  14.                             Copyright (C)1987-1991
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                    Preface
  21.                                   ---------
  22.  
  23.          This is NOT meant to tell you how to setup DOORs on your BBS,
  24.          just how to setup DORPCH38 doors.
  25.  
  26.  
  27.                                 Support Shareware
  28.                                -------------------
  29.  
  30.          Thank you for obtaining this door program.  Many hours of coding
  31.          have gone into its development.  Like all shareware products,
  32.          You're encouraged to register this program if it meets your needs.
  33.          Supporting Shareware helps insure the future development of such
  34.          programs and will entitle you to support from their authors.
  35.  
  36.  
  37.                               Environment variables
  38.                              -----------------------
  39.  
  40.          Two environment variables must be set in your AUTOEXEC.BAT file:
  41.  
  42.          SET LIB=<drive:><path to DORPCH38.EXE>  Note: ONLY the PATH!
  43.  
  44.          Example:  SET LIB=C:\MYLIB
  45.  
  46.          The DORPCH38.EXE run-time library and DOORPCH.CFG files must then
  47.          be placed in this directory.  I'd suggest a separate directory as
  48.          I do on my system and include it in your PATH statement.
  49.  
  50.  
  51.          SET DOORPCH=PCB     This variable is required by prior versions
  52.                              of DOORPCH, but not by DORPCH38.EXE.
  53.  
  54.          For your convenience DOORPCH v3.8 also supports the following three
  55.          new variables:
  56.                         %NODE% , %DRIVE% , and %DIRECTORY%
  57.  
  58.                         SET NODE=1          (ie. 1 , 2 , etc.)
  59.                         SET DRIVE=C:        (ie. C: , D: , etc.)
  60.                         SET DIRECTORY=\BBS\ (ie. \PCB\ , \BBS\ , etc.)
  61.  
  62.          These may be used to allow a single ZODIAC.CFG file for all nodes.
  63.          When using these variables please remember the combination of them
  64.          MUST form a valid DOS 'drive:\path\' pointing to the location of the
  65.          BBS interface file.
  66.  
  67.  
  68.                                    DOORPCH.KEY
  69.                                   -------------
  70.  
  71.          DoorPch is released as a completely UNcrippled program.  Upon
  72.          registering DoorPch you'll receive a DOORPCH.KEY file.  This
  73.          file should be put in the 'SET LIB = ' directory along with the
  74.          DORPCH38.EXE and DOORPCH.CFG files.  Upon exiting, all DOORs
  75.          using DoorPch v3.8 will then say 'This copy of DoorPch v3.8 is
  76.          registered to: ' and your BBS name, your name and your serial
  77.          number.
  78.  
  79.  
  80.                                     DOOR Setup
  81.                                    ------------
  82.  
  83.          Make a batch file to run the DOOR as described in your BBS
  84.          documentation.
  85.  
  86.  
  87.  
  88.          @ECHO OFF
  89.          You may use the environmental variables to only require one
  90.          ZODIAC.CFG file for multiple nodes.
  91.  
  92.          C:\BBS\DOOR.SYS             <== The drive:\path\filename
  93.                                          of your BBS interface file
  94.                                          which is the same as
  95.  
  96.                                          %DRIVE%%DIRECTORY%DOOR.SYS
  97.  
  98.                                          using the above variables.
  99.          Haley's Comment BBS         <== The name of your BBS.
  100.          Roland                      <== The SysOp's FIRST name.
  101.          Haley                       <== The SysOp's LAST name.
  102.          Your SysOp                  <== The name of the DOOR's donor.
  103.          CAN                         <== Date format (Canadian) or change to US
  104.          C:\EVENT\TODAY.LCL          <== Path to the birthday list
  105.          C:\PCB\NEWS                 <== Path to the birthday greeting file
  106.          100                         <== Max number of lines for greeting file
  107.          C:\PCB\ZODIAC\BLT-1         <== Path to the Horoscope bulletin
  108.  
  109.  
  110.         This program not only works as a fun door for your users, but
  111.         also a utility for you to recognise your users birthday and to
  112.         make you a Horoscope bulletin. The door gives your users an
  113.         interpretation of their birth sign and biorythms. They can also
  114.         enter a friend or relatives name to find out their particular
  115.         horoscope.
  116.  
  117.         The utility allows you to wish your users a happy birthday on
  118.         their date and it also makes a bulletin of that months
  119.         horoscope.
  120.  
  121.         To run the utility, you must enter a couple of lines in your
  122.         EVENT.SYS file. for example you must direct the event to the
  123.         area where ZODIAC.EXE resides and then use the command
  124.  
  125.                                       Example:
  126.  
  127.         CD\DOORS\ZODIAC      <== Goes to where the door resides
  128.         ZODIAC BIRTHDAY      <== Runs ZODIAC.EXE birthday utility
  129.  
  130.  
  131.                                       Format for Birthday List:
  132.  
  133. *mmddyyyy Birthdays
  134. *-------- ------------------------------------------------------------
  135. B03031942 Roland Haley SysOp of Haley's Comment BBS.
  136.                                                                        
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.                             Command-line parameters
  144.                            -------------------------
  145.  
  146.          This parameter may be used when starting a DOORPCH v3.8 DOOR.
  147.  
  148.          /LOCAL                      <== Allows local usage of the DOOR as
  149.                                          the SysOp.
  150.                                          (ie. ZODIAC ZODIAC.CFG /LOCAL)
  151.  
  152.  
  153.                                    LIBRARIES
  154.                                   -----------
  155.  
  156.          All DOORPCH v3.8 DOORs require the DORPCH38.EXE run-time library
  157.          and the Microsoft (R) QuickBASIC 3.0 run-time library, BRUN30.EXE,
  158.          be in your path.  Your DOOR program may have come with these files
  159.          in the archive file.  If they are not present, this DOOR program
  160.          WILL NOT RUN.  You should contact the DOOR author if the files
  161.          are missing.  You require one and only one version of these two
  162.          libraries for ALL DOORPCH v3.8 DOORware.
  163.  
  164.  
  165.  
  166.                                   DOOR operation
  167.                                  ----------------
  168.  
  169.          When this DOOR is in operation you have complete control over the
  170.          caller.  This DOOR was written using DOORPCH v3.8.  The logic is
  171.          safe and every precaution has been taken to insure this code works
  172.          flawlessly.  If it doesn't, please let us know.  Many
  173.          function/operational keys are at your disposal:
  174.  
  175.          F1    -   Displays the version of DOORPCH compiled and linked
  176.                    into the DOOR.
  177.          F2    -   Displays a caller's Alias if one is used via the DOOR.
  178.          F3    -   Toggles Local Music ON/OFF.
  179.          F4    -   Toggles the Bell ON/OFF.
  180.                    Value is returned to BBS when DOOR completes.
  181.          F5    -   DOS Shell.  Allows the SysOp to exit to DOS from inside
  182.                    a DOOR.
  183.          F6    -   Toggles the Graphics mode of the caller ON/OFF.
  184.                    Value is returned to BBS when DOOR completes.
  185.          F7    -   Toggle the caller alarm ON/OFF.
  186.                    Value is returned to BBS when DOOR completes.
  187.          F8    -   Involuntarily returns the caller to the BBS.
  188.          F9    -   Toggles the display ON/OFF.
  189.                    Value is returned to BBS when DOOR completes.  Some doors
  190.                    may force the display ON, but the original OFF value will
  191.                    be returned to the BBS if this occurs.
  192.          F10   -   Activates SysOp/Caller CHAT mode within the DOOR.
  193.          ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  194.          ALT-H -   HELP key for lines 24/25 capabilities.
  195.          UP    -   Allows the SysOp to add additional time for the caller.
  196.                    Value is returned to BBS when DOOR completes.
  197.          DN    -   Allows the SysOp to subtract time from the caller.
  198.                    Value is returned to BBS when DOOR completes.
  199.          ALT-N -   Some BBSs use SysOp next on control/indicator.
  200.                    Value is returned to BBS when DOOR completes.
  201.          ALT-X -   Some BBSs will exit after current caller completes their
  202.                    session.  Value is returned to BBS when DOOR completes.
  203.  
  204.  
  205.                             Example: device = ANSI.SYS
  206.                             --------------------------
  207.  
  208.          DOORPCH uses this device driver for displaying all colors and
  209.          screen positioning to the local console.  ANSI Color Graphics will
  210.          always be sent to the local console if you are using a color
  211.          monitor.  If a caller is in non-graphics mode you will still see
  212.          colors if you have a color monitor.  The reverse is also true.
  213.          If the caller is in graphics mode and the local console is a mono
  214.          monitor then colors will NOT be displayed to the local console.
  215.  
  216.  
  217.                                        BELL
  218.                                       ------
  219.  
  220.          DOORPCH logic will not allow a BELL to be sent to the local
  221.          console when the local screen is inactive (F9 OFF) or the caller
  222.          alarm is toggled off (F7 OFF).  This, of course, assumes the
  223.          DOOR author follows the DOORPCH rules.
  224.  
  225.  
  226.                                       Errors
  227.                                      --------
  228.  
  229.          All errors should recover and cause the DOOR program to exit
  230.          gracefully and return to the main system.  All errors are logged
  231.          in the 'DOORPCH.ERR' file found in the 'SET; LIB =' directory.  The
  232.          error number and line number are included with the date and time.
  233.          Errors will be either caused by the main module (the authors code,
  234.          contact him/her) or the DOORPCH sub (contact Raymond Clements).
  235.          It should NEVER cause the BBS to hang.  If your BBS hangs, you are
  236.          requested to contact the appropriate party and report the error and
  237.          circumstances that caused it.  Because we are using Microsoft's (c)
  238.          QuickBASIC 3.0 run-time routines, it is possible that BASIC will
  239.          detect a fatal error condition.  As mentioned above, we have taken
  240.          every precaution, but simply cannot code for every error condition.
  241.          If the DOOR author follows all the rules, the DOOR should run without
  242.          error.
  243.  
  244.  
  245.                                     REGISTRATION
  246.                                     ------------
  247.  
  248.          To register this door, please read and fill out the ORDER.FRM which
  249.          is included in this ZIP.
  250.  
  251.  
  252.                                   HALEY'S  COMMENT  BBS
  253.                                  -----------------------
  254.                                     PCBoard v14.5a/E3
  255.  
  256.                                      (519) 469-3028
  257.                                      (519) 469-3173
  258.                                      (519) 539-6851
  259.  
  260.